home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmFontListGetNextFont.z / XmFontListGetNextFont
Text File  |  1998-10-30  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttGGGGeeeettttNNNNeeeexxxxttttFFFFoooonnnntttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttGGGGeeeettttNNNNeeeexxxxttttFFFFoooonnnntttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttGGGGeeeettttNNNNeeeexxxxttttFFFFoooonnnntttt - A font list function that allows
  10.           applications to access the fonts and character sets in a
  11.           font list
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           #include <Xm/Xm.h>
  15.           BBBBoooooooolllleeeeaaaannnn XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttGGGGeeeettttNNNNeeeexxxxttttFFFFoooonnnntttt(
  16.           XXXXmmmmFFFFoooonnnnttttCCCCoooonnnntttteeeexxxxtttt ccccoooonnnntttteeeexxxxtttt,
  17.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCChhhhaaaarrrrSSSSeeeetttt ****cccchhhhaaaarrrrsssseeeetttt,
  18.           XXXXFFFFoooonnnnttttSSSSttttrrrruuuucccctttt ********ffffoooonnnntttt);
  19.  
  20.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  21.           This page documents Motif 2.1.
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttGGGGeeeettttNNNNeeeexxxxttttFFFFoooonnnntttt accesses the character set and font
  25.           for the next entry of the font list. The application first
  26.           uses the XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttIIIInnnniiiittttFFFFoooonnnnttttCCCCoooonnnntttteeeexxxxtttt routine to create a font
  27.           list context.  The application then calls
  28.           XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttGGGGeeeettttNNNNeeeexxxxttttFFFFoooonnnntttt repeatedly with the same context. Each
  29.           succeeding call accesses the next element of the font list.
  30.           When finished, the application calls
  31.           XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttFFFFrrrreeeeeeeeFFFFoooonnnnttttCCCCoooonnnntttteeeexxxxtttt to free the allocated font list
  32.           context.
  33.  
  34.           This routine allocates memory for the character set string
  35.           that must be freed by the application.  The function
  36.           allocates memory for _c_h_a_r_s_e_t.  The application is
  37.           responsible for managing the allocated memory.  The
  38.           application can recover the allocated memory by calling
  39.           XXXXttttFFFFrrrreeeeeeee.
  40.  
  41.           This function is obsolete and exists for compatibility with
  42.           previous releases. It is replaced by XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttNNNNeeeexxxxttttEEEEnnnnttttrrrryyyy.
  43.           If XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttGGGGeeeettttNNNNeeeexxxxttttFFFFoooonnnntttt is passed a context that contains a
  44.           font set entry, it will return the first font of the font
  45.           set. The next call to the function will move to the next
  46.           entry in the font list.
  47.  
  48.           _c_o_n_t_e_x_t   Specifies the font list context
  49.  
  50.           _c_h_a_r_s_e_t   Specifies a pointer to a character set string; the
  51.                     routine returns the character set for the current
  52.                     font list element
  53.  
  54.           _f_o_n_t      Specifies a pointer to a pointer to a font
  55.                     structure; the routine returns the font for the
  56.                     current font list element
  57.  
  58.      RRRREEEETTTTUUUURRRRNNNN
  59.           Returns True if the returned values are valid; otherwise,
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttGGGGeeeettttNNNNeeeexxxxttttFFFFoooonnnntttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttGGGGeeeettttNNNNeeeexxxxttttFFFFoooonnnntttt((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           returns False.
  75.  
  76.      RRRREEEELLLLAAAATTTTEEEEDDDD
  77.           XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt(3) and XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttNNNNeeeexxxxttttEEEEnnnnttttrrrryyyy(3).
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.